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Z80 Development System - Text Editor 


SD SYSTEMS TEXT EDITOR V3.0 
OPERATIONS MANUAL 


COPYRIGHT 1978 SD SYSTEMS 

NOVEMBER. 1978 

ALL RIGHTS RESERVED 

NOTE: THIS DOCUMENT AND ASSOCIATED SOFTWARE IS COPYRIGHTED BY AND 
PROTECTED BY LICENSE AGREEMENT WITH SD SYSTEMS. UNAUTHORIZED 
DUPLICATION BY ANY MEANS IS PROHIBITED. uwauiHUKiZED 

1.0 INTRODUCTION 

the user in origination and 
modification of assembly language source programs and English text 
documentation. The Editor resides on a 32K system diskette It 

permits random access editing of ASCII diskette files. The Editor, i# 
designed for usage with any CP/M(*) compatible disk operating' system 
(DOS) using a Z80 microprocessor. ^ 

The Text Editor permits random access editing of ASCII diskette -files 

character basis. Whole lines and character strings 
embedded within lines can be easily accessed, changed, deleted, or 

diskette file. The sise of the file to be 
edited is limited only by diskette capacity. All I/O operations to the 
diskette are transparent to the user. 

The Editor is resident on diskette. When loaded, it starts at RAM 
address lOOH. Editor buffers and variables are placed in RAM between 
the^top of the Editor and the bottom of the Operating System. All I/O 
is done with the console device and the disk. 


2.0 DEFINITIONS 


SOURCE - ASCII characters comprising a Z80 assembly language program or 
some other text. 

PILE - a diskette file which contains the SOURCE. 

LINE “a single source statement which ends with a carriage return. 

LINE POINTER - the position in the source where the next action of the 
Editor will be initiated. 


*) CP/M is a registered trademark of Digital Research of Pacific Grove. 
California. ' 
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CURRENT LINE - the line in the source pointed to by the LINE POINTER. 

LINE NUMBER - the decimal number of a line, beginning at one (0001) for 
the .first line in a file and increasing sequentially 'for each line 

number allowed is 9999 (decimal). Line numbers are 
thaJ^ ^ file progresses. This means 

deleted from a file, all lines are 

automatically renumbered. 


lines in a file immediately 
following the current line. Inserted lines are assigned 
increasing line numbers. 

DELETE - removal of one or more lines from a file. 


sequentially 


3.0 USING THE EDITOR - CONSOLE INTERACTION 

All user interaction with the Editor is via the user console. The 
Editor issues prompts and messages to direct the user. The user 
responds by entering commands or data via the console keyboard. Each 
command or data line is terminated by a carriage return. 

The following conventions are used in this manual: 

(CR) stands for carriage return. 

All user input is underlined. 

User input which must be entered exactly as shown 
is in upper case letters. 

User input which is variable is shown in lower case. 

4.0 USING THE EDITOR - ENTERING COMMANDS 

The Editor prompts for a command with an asterisk (*). The user mav 

then enter commands via the console keyboard. Modification of the 

input,^such as rubout, backspace, and line delete, is supported bv the 

operating system. entered in lower case as well as upper case 

Several commands may be entered on one line. Blanks and commas are 

ignored on input. A command line is terminated by a carriage return 

A command line may have up to 80 characters in it, including the 
carriage return. ^uuxng tne 

All commands consist of one character followed by an optional operand 
The operand may be separated »from the command by zero or more blanks or 
commas. The operand may be a decimal number in the range 0-9999 Thl^ 
specifies the number of lines upon which the command is to operate. 
Alternatively, the operand may be two decimal numbers separated bv a 
minus sign this case, the command takes effect on lines 

numbered from the first number in the operand through and including the 
second number. If the operand is not entered, it assumes a valSe of 
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one {except for the 'F' command). 

EXAMPLE 

V 

-VIEW command with no operand. The operand 
value assumes the value of one. 

V5 or V 5 or V,5 

-one operand shown which acts on the next 5 
lines in the source file. 

V42-45 or V 42-45 or V,42-45 

-two operands entered. The VIEW command acts 
on lines numbered 42 throuqh 45. 


5.0 USING THE EDITOR - FIRST STEPS 


booting up DOS. the Text Editor may be executed by the following 
command: 

A>EDIT'f ilename (CR) r 


-where filename is the name of the diskette file 
to be edited on the currently selected disk. 

The file may not have an extension of COM, BAR, 
or $$$. 

The Editor responds with the following message: 

SD SYSTEMS EDITOR 

EXAMPLE 

A>EDIT MyFILE(CR) 


-user selects to run the Editor to edit the file 
named 'MYFILE* on the currently selected disk. 

SD SYSTEMS EDITOR 

If the file does NOT exist on the diskette, then the Editor outputs the 
following message on the console: 

***NEW FILE 

-Editor indicates that a new file is being created. 

The Editor then enters the 'DATA MODE* and waits for lines of data to 
be entered by the user: 

**‘DATA MODE 
0001 

-Editor prompts for data lines starting with 
line number 0001 (see I-INSERT command). 

At the end of editing, the new file will automatically be created. 
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If the file does exist on the disk, then editing of that file will be 
done, and the Editor prompts for a command: 

* 

-Editor prompts for a command (see below). 

At the end of editing, the original file will be renamed with an 
extension of 'BAK'. The file which was edited will have all the 
changes in it. 

The following pages describe each of the Editor commands in detail. 


6.0 EDITOR COMMANDS 


6.1 An - ADVANCE 


Format; 

or 


An 

an 


-where n is a decimal number. 


This command is used to advance the line pointer (toward the end of the 
file) a specified number of lines. If the operand n is not entered or 
it is zero, then the pointer will be position to the next line in the 
file. The line which is accessed is printed on the console after this 
command. 


EXAMPLE 

*A(CR) 

-user advances to next line. 

0015 ANY STATEMENT. 

-the next line with its line number is printed on 
the console. 

*A5(CR) 

-user advances 5 lines from current pointer. 

0020 SOME STATEMENT 

-Editor prints line number and the line. 

-Editor prompts for a command. 

If the user attempts to advance the line pointer beyond the end of the 
file, then an end-of-file indicator message wi"*! be printed on the user 
console. The line pointer will be on the last line of the file. 


EXAMPLE 
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*A9999(CR) 

0438 LAS;“L?SE^or"FILE 
***EOF 

-Editor prints last line of file and end-of-file 
indicator. 

* • 

-Editor prompts for a command. 


6.2 Bn - BACKUP 


Format; 


-where n is a decimal number. 

This command is used to backup the line pointer (toward the bfeginninq 
of the file) a specified number of lines. If the operand n is zero or 
It IS not entered, then the pointer is positioned to the previous line 
in the file. The line which is accessed is printed on the console. 

EXAMPLE r 

*B(CR) 

-user backs up over one line in the file. 

0019 A 'LINE OF INFORMATION 

"Editor prints the line number and the line. 

*B4 (CR) 

-user backs up 4 lines -from current position. 

0015 SOME LINE 

^ -Editor prints the line number and the line. 

-Editor prompts for a command. 

If the user attempts to back up the line pointer past the start of the 
file, then a top-of-file indicator will be printed on the user console. 
The line pointer will be on line number 0001. 


EXAMPLE 


*B9999(CR) 

-user backs up over a large number of lines. 

***TOF 

0001 FIRST LINE OF FILE 

-Editor prints top-of-file indicator and first 
line of the file. 

* 

-Editor prompts for a command. 
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6.3 Cn /stringl/string2/ - CHANGE STRING 


Format; 


or 


Cn/stringl/string 2 / 
cn/string 1 /string 2 / 

-where n indicates the number of occurrences to chanap 
stringl represents the characters to b^Jhanged, ^ ' 
represents the substitute or new characters, 
d / represents a delimiter character which does 
not appear in either string. 

2 ero or if it is not entered, then only one occurrence of It?inolwilf 
be changed. In this case, only the current line will L searched 

stringl. If stringl is not found irihe current finf 

(*r The li^roointerwiir*'?^"^ and a new command pJompt 

1 ). Tne line pointer will stay on the same line. ^ 

If the operand n is greater than 1, then the search for occurrences of 
stringl occurs in a sequential manner starting with the current line 
Each Une which ia changed is printed on the console" M^eJ Sn 

chenIJd pointer will be on the last line that wU 

If the nth occurrence of stringl is not found before the end 
encountered, then the last line of the file is orfntS^ 
by the Editor, as well as an end of .file indicator {***EOP) The line 
pointer will be on the last line of the file. . The line 

characters in it, then character stringl will be 
deleted each time it is encountered by the change command. 

EXAMPLES 

*V(CR) 

-user views current line. 

0009 THIS IS A RECORD 

—Editor prints line number and line. 

*C /THIS/THAT/(CR) 

...... -user enters change command. 

0009 THAT IS A RECORD 

-Editor prints it. 

*C/IS/WAS(CR) 

irahoSeL* ‘he last delimiter 
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0009 THAT WAS A RECORD 
*C /WAS //(CR) 

0009 Characters. 

*c 2 /T/V/{CR) 

inserted between the command 
mSre r^dabir"^ string definition to make the command 

0009 VHAV A RECORD 
*C4/VHAV/THAT/(CR) 

-this is a multiple change request which will search 

forward in the file starting with the current line 
0009 THAT A RECORD '-unenc line. 

0024 SOME TIMES THAT IS 

“^^ifor prints out each line that is changed 
0043 LAST LINE OP FILE y • 

•**EOF 

-Editor reached the end of the file before any more 
changes could be done. An end-of-file indicator 
message is printed. The line pointer is on the last 
line in the file. 


-Editor prompts for a command. 


6.4 Dn - DELETE 


Format: 


Dn-m 


dn-m 


-where n and m are decimal numbers. 


This command is used to delete, or remove, the specified lines from the 
operand is not entered or is zero, then only the current 
that line numbers are assigned dynamically as 
editing progresses. This means that lines in a file essentially qet 
renumbered each time one or more lines are deleted from the file. 

EXAMPLE 


'D(CR) 


-user deletes the current line‘from the file. 

The line pointer is on the next line in the file. 


Lifeboat Associates 280 Development System Version 3.2 












280 Development System - Text Editor 


*D4(CR) 


-user selects to deiete 4 lines startinq with 
•D4-15(CR? 


Owffroi'Jhe including 


-Editor prompts for a command. 


6.5 En - EXCHANGE 


Format: 


En-m 


en-m 


-where n and m are decimal, numbers. 


II:L^teT:u^hrDATrMODE‘'^t'?r‘""^ withnewH„es to bt 

sequence: equivalent to the command 


-delete lines 
-backup one line 
-go to DATA MODE 


6.6 Fn - PRINT FLAG 


Format: 


-where n-0 will inhibit printing after all hm- 
the V-VIEW command, and n not « 0 will allow 
printing after all change or access commands. 


a«essed‘oJ cSaS"*"'' '’"tJe'fo??"'?® “y lines which ar 

*n. Bn, Cn, Ln! In^Vn. to JeduL^H!*"'’' » line 

Slower device (such as a teletvnpi print out time on 

print out on all of the comiandl iiceSi v-?S? 
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6.7 G file - GET FILE COMMAND 


Format 

or 


G filename 
g filename 

-where filename is the name of a file on the 
selected disk. 


This command is used to obtain lines from a given file on disk and 
insert them in sequence following the current line. All lines in the 
file requested are read. The file which is read is not altered in any 
way. This command can be used with the P - PUT command to move blocks 
of text around within a file being edited (See P - PUT command for 
example). 


6.8 I - INSERT COMMAND 


Format: 

I 

or 

i 

This command is used to insert data lines into the file being edited br 
to build new files. The inserted lines always FOLLOW the current line. 
After the command is entered, the Editor responds with the message: 

***DATA MODE 

The user then enters data lines ending with carriage returns. The 
Editor prompts with the line number for each line to be inserted. To 
terminate the insertions, the user enters a single carriage return. 
Note that blank lines must be entered as 'space carriage return' 
because a single carriage return terminates the DATA MODE. After the 
user terminates the DATA MODE, the Editor prompts for a new command 
(*). Lines can be inserted before the first line of a file by using 
the T - INSERT AT TOP command. Note that line numbers are assigned 
dynamically while editing progresses. This means that the lines of a 
file essentially get renumbered whenever new lines are inserted. 

EXAMPLE 

*I(CR) 

-user selects data mode to insert lines into the file 
being edited. 

***DATA MODE 

-Editor responds with message 
0004 THIS IS AN INSERTED LINE.(CR) 


the line number being entered is printed by the 
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tor 


0005 then enters the line of data. 

-user terminates DATA MODE with a carriage return. 
-Editor prompts for another command. 

Note that modification of entered dai-a i* 

being typed just as in the DOS svsfem done while they are 

characters long. system, inserted lines can be up to 128 

6.9 Ln - GO TO LINE NUMBER n 


Format: 

or 


Ln 

In 


This command positions ♦-he • . 

Operand is zero or it is not number n. ■ If the 

accessed. Any line number can be'^accessed'^'fnumber 0001 le 
file. The line which is accessert^nM *7 Position in thj 

line number cannot be found because oonsole. if the 

number in the file, then the pointirwill Je than the last line 

line in the .file and an end-o?-?ile indicatir 

EXAMPLE indicator message will be printed. 


*L10(CR) 

0010 THIs“lsVLlNr§F ii?A 

‘L2001(Cr“"® “i.th its line number. 

094 3 LAS;'‘nSE"F'|JtE“""'™‘’" 

“‘EOF Isst line Of file. 

*L1(CF) »" end-of-file Indication. 


***TOF selects line number 1. 

0001 FIRST LINE OF FILE 


“Editor prompts for a command. 
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6.10 Pn file -• PUT 


Format 

or 

or 

or 


Pn filename 

pn filename 

Pn-m filename 

pn-m filename 
-where 
is the 


n and m are decimal numbers and filename 
name of a file on the selected disk. 


This command is used to output one or more lines to a file on disk. 
This can be used to break up a given source module. It can also be 
used with the G - GET command to move blocks of text around in a file 
being edited. If the operand is not entered or it is zero, then only 
one line will be output. Lines of text which are output by the PUT 
command are not deleted. They may be deleted via the D - DELETE 
command after the PUT command is used. The filename specified must ntff 
be the same as the current file being edited. If the file already 
exists on disk, it is erased before any lines are output to it. After 
the PUT command is used, the file output to the disk remains on the 
disk. 


EXAMPLE 

*P25-30 TEMP(CR) 


-user outputs lines 25 through 30 to a file 
called TEMP. The space between the number and 
the 'filename is not required. 

*D25-30(CR) 


-user deletes lines 25 through 30 from file 
being edited. 

*L1(CR) 


-user accesses line number one. 
*G TEMP(CR) 


-user reads lines from file TEMP and places them 
after line number one. This effectively moves 
lines 25-30 to just after line 1. The space 
between the command and the filename is not 
required. 

* 

-Editor prompts for a command 

6.11 0 - QUIT 


Format: 

0 
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or 


This command returns control to the Operating System. The orlolnal 

£ len^e Of Iak a!? of'’ ‘‘’"a?"'!" with a se«^d«i 

tiiename Of BAR. All of the editing will be saved in the file under 

of%ditiig!^ <3‘Jring the course 


6.12 Sn /string/ - SEARCH FOR STRING 


Format; 


or 


Sn /string/ 
sn /string/ 

-where n is the number of occurrences to be found 
string represents any set of characters which is to 
be searched for, and / represents a delimiter character 
which does not appear in the string. 

This command searches the file, starting with the NEXT line, for n 
occurrences of the character string between the delimiters. Each line 
which contains the string will be printed on the console. The pointer 
IS positioned on the line of the nth occurrence of the string. If the 
nth occurrence of the string cannot be found before the end of the file 
being edited^ then the Editor issues an end-of-*file indicator 
in the^file^ always searches forward (toward increasing line numbers) 

Any character which does not exist in the string to be searched for roav 
be used as a delimiter. The second delimiter may be a carriage return. 
If the operand n is zero or it is not entered, then only the first 
occurrence of the string will be sought. ^ 


EXAMPLE 


*S /ORD/(CR) 

-user selects to search forward in the -file, beginninq 
with the next line, for the string 'ORD*. Only the 
first occurrence of the string is sought. The blank 
between the command and the string is not reauired 

-Editor prints the line number and line when the 

string is found. The line pointer is on line 0021 
*S10/9AH/(CR) un iine uuxi. 


***E0F 


-user selects to search for and view the next 
10 occurrences of the string '9AH*. 

-Editor encountered the end of the file and found 
no occurrences of the string. The end-of-file 
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indicator is printed. 


-Editor prompts for a command. 


6.13 T - INSERT AT TOP 


Format; 


This command inserts data lines at the top (start) of the file BEFORE 
the first line in the file. See the I-INSERT command for proper usage. 


6.14 Vn - VIEW 


Format! 


Vn-m 


vn-m 


-where n and m are decimal numbers. 


This command prints the specified lines on the console device. The 
line pointer is updated to the last line printed. If the operand n is 
zero or is not entered, then only the current line is printed. 


EXAMPLE 


*V(CR) 

-user views current line on the console. 
0009 THIS IS A LINE 

-Editor prints line number and line. 

*V3(CR) 

-user views current line plus two more. 

0009 THIS IS A LINE 
0010 THIS IS NEXT LINE 
0011 THIS IS ANOTHER LINE 

-Editor prints 3 lines on the console. The 
line pointer now points to line 0011. 
*V3-4(CR) 


-user selects to view lines 3 through 4. 
0003 SOME LINE OF DATA 
0004 NEXT LINE OF DATA 

-Editor prints lines 3 through 4. 
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I A , -Edltor ptompts for a command. 

7.0 EDITING LARGE FILES 


beloJr?he'EdltSrreaponf""“°"" ‘ «PP='«"t 


8.0 EDITOR MESSAGES 


If the user enters an unrecognixable file name, a syntax error will hp 

indicated and the Editor will return to DOS. If the user enters an 

unrecognizable command, then the Editor will print a question mark and 
another command prompt; ^ question marK ana 


EXAMPLE 


*R20(CR) 


All I/O errors to and from disk result in appropriate error messaaes 
Edito-r!^^"^^ should be backed up on another disk before using ^the 

The Editor prompts with several other messages as editing progresses; 

:d:tfng'Jf\; aueid^exisang .fn"" 

;;:n"Edi?oTc;mman^r^^^ 

e^JoSntLeS"''''"® (beginning of file) has been 

***EOF - indicates that the end of file has been encountered. 

***END OF EDITING - indicates that the Editor has successfuliv 
completed. Control is then returned to the DOS Operating System! 

WINDOW. USE ‘ADVANCE' TO SEE NEXT LINE - occurs only with 
the VIEW command. Follow the directions. ^ 
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9.0 SAMPLE EDITING SESSION 


The user is urged to follow the steps given here to become acduainted 
with the Editor. ^ 

>EDIT NEWFILE(CR) 


- user selects to run the Editor to create a new file 
SD SYSTEMS EDITOR VI.0 
***NEW FILE 

“Editor indicates that a new file is being created 
***DATA MODE 


0001 

- Editoi prompts for data lines to 
the console device. User begins 
program. 

; A SIMPLE SAMPLE PROGRAM(CR) 

be input 'from 
keying in a 

0002 

LD A,(LABI)(CR) 

r 

0003 

LD E,0(CR) 


0004 

CALL SUBl ;S0ME COMMENT(CR) 


0005 

LOOP LD (HL),0 ;STUFF 2ER0S(CR) 


0006 

INC HL(CR) 


0007 

DNZ LOOP-$ ;LOOP FOR ALL(CR) 


0008 

END(CR) 


0009 

(CR) 



-user terminates DATA MODE. 
*B99V20(CR) 


-user backs up to beginning of file and 
views all lines. 


***EOF 

-Editor indicates end of file encountered. 

*L7(CR) 


0007 DNZ LOOP-$ ;LOOP FOR ALL 

-user views line 7 and observes an error. 
*C /DN/DJN/(CR) 


-user modifies the line. 
0007 DJNZ LOOP-$ ;LOOP FOR ALL 
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-Editor prints the changed line 

*Q(CR) 


-user terminates the editing session. 
10.0 EDITOR COMMAND SUMMARY 


An advance n lines 

Bn backup n lines 

Cn/sl/s2/ change n occurrences of si to s2 

Dn delete n lines 

En exchange n lines 

Fn turn on or turn off print flag 

G file get file and insert into current file 

I insert lines of data 

Ln go to line number n 

Pn file put n lines out to file 

Q quit, save all editing and return to DOS 

Sn/sl/ search for n occurrences of si 

T insert lines at top of file before first line 

Vr view n lines on the console 
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SD SYSTEMS RELOCATING 280 ASSEMBLER VERSION 3.2 

OPERATIONS MANUAL 

COPYRIGHT SD SYSTEMS 

NOVEMBER 1978 

ALL RIGHTS RESERVED 


NOTE: THIS DOCUMENT AND ASSOCIATED SOFTWARE IS COPYRIGHTED BY AND 
PROTECTED BY LICENSE AGREEMENT WITH SD SYSTEMS. UNAUTHORIZED 
DUPLICATION BY ANY MEANS IS PROHIBITED. 


1.0 INTRODUCTION 


The SD SYSTEMS Z80 ASSEMBLER is provided on a standard CP/M compatible 
diskette. It provides the means for assembling 280 programs. The 
Assembler (ZASM) reads standard Z80 source language (Mostek and Zilog 
definition) and outputs an assembly listing and object code on disk* 
The object code is in industry standard hexadecimal format extended for 
relocatable and linkable programs. The Assembler supports conditional 
assembly, a printed symbol table, and a printed cross reference table. 
The Assembler can assemble any length program limited only by the 
symbol table size which is based on available memory and available disk 
space. Typically over 300 symbols are allowed in one assembly. 

Any Z80 based system which is running 32K CP/M compatible disk 
operating system (DOS) can use the 280 Assembler. 

2.0 COMMAND SUMMARY 


ZASM file.ext(CR) 

- executes assembler to assemble a file 

- object output is on file.OBJ 

- listing output is on file.PRN 

OPTIONS 


print cross reference table 
ho listing output 

direct assembly listing out to listing device 
no object output 
pass 2 only 

reset symbol table for pass 2 only operation 
print symbol table 

direct assembly listing out to console device 
3.0 DEFINITIONS 


In this manual, the following symbols are used: 
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- (CR) means carriage return. 

- all user input is underlined. 

“ use. input which is all upper case must be entered exactly 
as shown. ^ 

- user input which is lower case is variable. 


*" source program. Each source module is 
assei blwd into one object module by the Assembler. The end of a source 
module is defined by an 'END* statement or CP/M end of file code (lAH) 


OBJECT MODULE - the object output 
module. The object module contains lin 
relocating information, machine code, 
by the SD SYSTEMS Linker. The object 
module is output to a disk file with 
Linker must then be used to link 
modules into a module loadable by the 
Operations Manual for more details. 


of the Assembler for one source 
king information, address and 
and checksum information for use 
module is in ASCII. The object 
extension OBJ. The SD SYSTEMS 
and relocate one or more object 
DOS. See the SD SYSTEMS Linkder 


LOAD MODULE - the absolute machine code of one complete program. The 
load module is defined on disk as an absolute object file with 
extension HEX. The file may be loaded by the DOS loader It is 
created by the SD SYSTEMS Linker from one or more relocatable object 
modules (secondary 'file name OBJ) which were created bv the 280 
Assembler. ^ 


LOCAL SYMBOL - a symbol in a source module which appears in the label 
field of a source statement. Aaoei 


INTERNAL SYMBOL - a symbol in a source (and object) module which is to 
be made known to all other modules which are linked with it by the 
Linker. An internal symbol is also called global, defined, public, or 
common. Internal symbols are defined by the GLOBAL pseudo-op. An 
symbol must appear in the label field of the same source 
symbols are assumed to be addresses, not constants, 
and they will be relocated when linked by the Linker. 


EXTERNAL SYMBOL - a symbol which is used in a source (and object) 
module but which is not a local symbol (does not appear in the label 
field of a statement). External symbols are defined by the GLOBAL 

symbols may not appear in an expression which uses 
operators. An external symbol is a reference to a symbol that exists 
and IS defined as internal in another program module. 


.®^^^**^TI0N - both internal and external symbols are defined as 

Which ace Interna? 


POSITION 
memory, 
module. 


INDEPENDENT - a program which can be placed anywhere in 
It does not require relocating information in the object 
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ABSOLUTE - a program which has no relocating information in tne object 

which is not position independent can be 
loaded only in one place in memory in order to work properly. 

RELOCATABLE - a program which has extra information in the object 
module which allows the Linker to place the program anywhere in memory. 

® P^ogi^am which has extra information in the object module 
which defines internal and external symbols. The Linker uses the 

information to connect, resolve, or link, external references to 
internal symbols. 


4.0 USING THE ASSEMBLER 


The_ SD SYSTEMS 280 ASSEMBLER is resident on a CP/M compatible system 

user first prepares his source module using the SD 
SYSTEMS Editor. To use the 280 Assembler, enter the following command; 

A>2ASM file.ext /xyz(CR) 


where 'file* is, the primary file name and 'ext' is the 
secondary file name of the file to be assembled and 
x,y and z are options described in paragraph 4.1. If 
the slash {/) is included in the command, with or 
without options, the option prompt will be skipped 
by the assembler. This is a useful feature when 
using the system under a SUBMIT batch skript. 

The object output of the Assembler is sent to the disk on file.OBJ, and 
the listing output is sent to the disk on filc.PRN. One or more object 
from the Assembler may be linked and -relocated by using the SD 
SYSTEMS Linker, which produces an absolute object file with extension 
HEX. The absolute object file may then be loaded via the DOS loader, 
and the listing file may be printed using PIP. If no options are 
selected in the initiating command line, the assembler will request 
them for the console with the following prompt: 

SD SYSTEMS 280 ASSEMBLER V3.2. OPTIONS? 

If no options are to be entered, the user enters 'carriage return'. 
The Assembler makes two passes over the source file. At the end of the 
first pass the following message is printed on the user console: 

PASS 1 DONE 

At the end of the assembly, the Assembler prints the total number of 
errors (in decimal) found; 

ERRORS=nnnn 


B-3 

Lifeboat Associates 280 Development System Version 3.2 












Z80 Development System - Relocating Assembl< 


Control is then returned to the DOS console processor (A>) 
4.1 ASSEMBLER OPTIONS 


When the Assembler outputs the message: 
OPTIONS? 

the user may enter any of the follow! 
carriage return: . 


ng codes, terminated with a 


‘ - prints s cross reference table 

- no listi^o assembly listing. 

^ this suppresses the assembly listina All 
"tors are output to the user console for this SlhoS 

• listing oif ^s’t^hrjntinfiLic“?2t^i-?jL‘Js 

■ the°Ajlemb?«^“' ‘ '“PPresaes object output from 

" option selects and runs only pass 2 

of the Assembler. The symbol table is left intact from 
a previous run of the Assembler. intact from 

reset the symbol table - clears the symbol table of all 
previous symbol references. This operation is 

“ in nserpJLariy for 

- symbol table - prints a symbol ?able at tlla end of the 

assembly listing. ^ 

“ list to console device - this option directs tha asscomKi,, 
listing out to the console device rather than to a disk^^ 


4.2 ERROR MESSAGES 


Any error which is found is denoted in the assemblv * 

se^?-ex"p!fna^:ry^^‘"''^ All’iesLgiri?: 


EXAMPLE 


H2: LC A,B 

***** ERROR ***** BAD OPCODE 


Certain errors abort the Assembler wh^n , 

error messages are output only to the user console^*^” ^Controt*^°^^ 

immediately returned to the DOS console processo? (a >1 

may occur during pass 1 or pass 2 processor (a>). Abort errors 
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4.3 OBJECT OUTPUT 


The Object output from the Assembler is put on diskette to the same 
Ef^'I'nn?* 3S the source input file, with a secondary file name 
or OBJ . One or more object modules may be linked and relocated hv 
the SD SYSTEMS Linker to produce an absolute object file with a 
secondary file name of 'HEX'. This file may then be loaded by the DOS 
loader. 


4.4 ASSEMBLY LISTING OUTPUT 

The assembly listing is put on diskette to the same primary file name 
as the source input 'file, with a secondary file name of 'PRN'. The 
user may insert tab characters in the source to obtain columns in the 
assembly listing. The value of each equated symbol will be printed 
with a pointer (>) next to it. The statement number and page number 
are printed in decimal. Assembler directives (see paragraph 6.4.1.) do 
not appear in the assembly listing, but they are assigned statement 
numbers. If the no listing option is selected, errors will ' be output 
to the user console. Any addresses which are relocatable will have a 
prime (') printed next to them. 



5.0 ADVANCED OPERATIONS 



5.1 PASS 2 OPERATION (SINGLE PASS OPERATION) 

The 280 Assembler can be used as a single pass assembler under the 
following restrictions: 

1. No forward symbol references are allowed. 

2. The NAME pseudo-op is not allowed. 

3. A cross reference table is not selected. 

The Assembler will correctly assemble 280 programs under the above 
restrictions using the pass 2 only option ('P'). This is useful for 
assembling data tables and certain types of programs. The Assembler 
symbol table should be reset to assure proper operation in this mode by 
using the 'R' option. 


5.2 ASSEMBLING SEVERAL SOURCE MODULES TOGETHER 

Several source modules may be assembled together to form one object 
module. The 'INCLUDE' pseudo-op may be used any number of times in one 
module to properly sequence a set of source modules. 

EXAMPLE NAME MYFILE jname of final object module 

INCLUDE FILEl 
INCLUDE PILE2 
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INCLUDE PILE3 
END 

- the object module named 'myfile' will be 
built by the Assembler from FILEI + FILE2 
+ FILE3. 


6.0 Z80 ASSEMBLY LANGUAGE 


An assembly language program (source module) consists of laKaie 
opcodes, pseudo-ops, sod comments in e sequincrSMcS de?^^ Jhi 

flu'owiSn«agrapL!""®''“'' ^‘’"«''*9e conventions are described in the 

6.1 DELIMITERS 

operands, and pseudo-ops must be separated from' 

?^e^feheSf tab charl““|^Al«? 09 H? 

deliJld! ‘he opcode by a colIn,' oilly!*'‘lf 


6.2 LABELS 


composed of one or more characters. if more than 6 
characters are used for the label, only the first 6 are recSgJiaed bv 
the Assembler. The characters in the label cannot include ' ( ) * + - 

nnmhlr^/n Q^’ addition, the first character cannot be a 

hv a ^ ^®" column if immediately followed 

by a colon (:). it does not require a colon if started in column ono 


EXAMPLE allowed 


LAB 

L923 

$25 


?s not requi] 
not allowed 


SLAB 

DAB 

L:ABC 


;STARTS WITH ILLEGAL CHARACTER 
^CONTAINS ILLEGAL CHARACTER 
;CONTAINS ILLEGAL CHARACTER 


6.3 OPCODES 

Of Z80 opcodes is documented in the 
MANUAL (which is available from SD SYSTEMS). 


'Z80 PROGRAMMING 


6.4 PSEUDO-OPS 

*he following pseudo-ops' .re®'J:j;g\iS*rbnS 
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DEFB n,n,n... - define byte - defines the contents of successive bytes 
to be the expressions n. ^ 

label DEFL nn - define label - sets the value of the label to the 
expression nn; may be repeated in the program with different values for 
the same label. At any point in the program, the label assumes the 
last previously defined value. 

DEFM 'aa' - define message - defines the contents of successive bytes 
of memory to be the ASCII equivalent code ot characters within quotes. 
Up to 63 characters may be in one message. Quote characters in the 
message may be defined by two successive quote characters 

DEFS nn - define storage - reserves nn bytes of memory starting at the 
current program counter, where nn is an expression. When loaded, these 
bytes will contain what was previously in memory. This pseudo-op 
cannot be used at the start or at the end of a program to reserve 
storage. 

DEFW nn,nn,nn... - define word - defines the contents of successive 
two-byte words to be the value of expressions nn. ' The least 
significant byte is located at the current program counter address, and 
the most significant byte follows it. 

END - end statement - defines the last line of the program. The ’ENb* 
statement is not required. 

ENDIF - end of conditional assembly - re-enables assembly of subsequent 
statements after an IF pseudo-op. 

label EQU nn - equate - sets the value of a label to the expression nn; 
can occur only once for any label. 

GLOBAL symbol - define global symbol - any symbol which is to be made 
known among several separately assembled modules must appear in this 
type of statement. The Assembler determines if the symbol is internal 
(defined as a label in the program), or external (used in the program 
but not defined as a label). 

IF nn - conditional assembly - if the expression nn is true (non-zero), 
the IF pseudo-op is ignored. If the expression is false (zero), the 
assembly of subsequent statements is disabled until an ENDIF pseudo-op. 
IF statements cannot be nested. 

INCLUDE file.ext - include source statements from another file - allows 
source statements from another input file to be included within the 
body of the given program. If the file cannot be opened properly, then 
assembly is aborted. The source module to be included must not end 
with an END pseudo-op (otherwise, assembly would be terminated). The 
INCLUDE pseudo-op cannot be nested. 

NAME symbol - module name - this pseudo-op defines the name of the 
program (source and object). The name is placed in the heading of the 
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assembly listing and in the first record of the object output. The 
module name defaults to 6 blanks. 

PSECT op - program section - may appear only once at the start of a 
source module. This pseudo-op defines the program module attributes 
for the following operands: 

REL - relocatable program (default) 

ABS - absolute program. No relocating 
information is generated in the object 
module. The module will be linked where 
it is otigined. 

ORG nn - origin - sets the program counter to the value of the 
expression nn. If mOre than one ORG statement is used in a source 
module, then the expression nn is a given ORG statement must be greater 
than a previous ORG statement. 

6.4.1 ASSEMBLER DIRECTIVES 

Assembler directives are pseudo-ops which are designed to format the 
assembly listing. 

eject a page of assembly listing, 
turn assembly listing on (default). 

- turn assembly listing off. 

- place title of characters 's' at top 
of each page of assembly listing, s can 
be up to 32 characters long. 


6.5 OPERANDS 

There may be zero, one, or more operands in a statement depending on 
the opcode or pseudo-op used. Operands in the Assembler may take the 
following forms: 

A GENERIC OPERAND, such as the letter *A', which stands for the 
accumulator. The following are Z80 generic operands: 

A - Accumulator 
B - B register 
C - C register 
D-D register 
E - E register 
F - F register 
H - H register 
L - L register 

AF - AF register pair 
AF' - AF* register pair 
BC - BC register pair 


EJECT 
LIST 
NLIST 
TITLE s 
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DE “ 
HL - 


DE 

HL 


register pair 
register pair 


SP - stack pointer register 
$ - program counter 


I - I register 
R - refresh register 


IX - 
lY - 


IX 

lY 


index register 
index register 


NZ - not zero 
Z - zero 
NC - not carry 
C ■“ carry 

PO - parity odd/not overflow 
PE - parity even/overflow 
P - sign positive 
M - sign negative 


A CONSTANT. The constant must be in the range 0 thru OFFFFH 
be in the following forms; »^rrrrH. 


It car 


DECIMAL 


HEXADECIMAL 

OCTAL 


BINARY 

ASCII 


- (default); any number can be denoted as 
decimal by following it with the letter D 
Eg: 35, 249D 

- must begin with a number (0-9) and end 
with the letter H. Eg: OAFIH 

3770^^277^ '"'ith the letter Q or O. Eg: 

■“ must end with the letter B. Eg; OllOllOB 

- letters enclose in quote marks will be 
converted to their ASCII equivalent value. 
Eg; 'A* = 41H 


A LABEL which appears elsewhere in the program. Note that lahAlc 
cannot be defined by labels which have not yet appeared in the program; 


EXAMPLE allowed 


not allowed 


I EQU 7 
H EQU I 
L EQU H 


L EQU H 
H EQU I 
1 EQU 7 


AN EXPRESSION. The Assembler accepts a wide range of expressions in 
the operand field of a statement. All expressions are evaluated left 
to right^constrained by the hierarchies shown below. Parentheses may 
be used to ensure cc .rect expression evaluation. ^ 
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operation 
equal to 

signed less than 

signed greater than 

signed less than or equal to 


operator 

= or .EQ. 
< 

> 

<= or =< 


hierarchy 


signed greater than or equal to >= or => 
not equal 

unsigned less than .LT. 
unsigned greater than Igt! 
unsigned less than or equal to .LE. 
unsigned greater than or equal .GE. 


reset overflow 


.RES< 


unary plus + 

unary minus 

logical NOT (one's complement) .NOT, 

multiplication * 

division / 


addition 

subtraction 

logical AND 
logical OR 
logical XOR 
logical shift right 
logical shift left 


.AND, 

.OR. 

.XOR. 

.SHR. 

.SHL. 


All operands and expressions are converted to'16-bit values. The onlv 
exception to this is when expressions take the form: ^ 

•character string l'='character string 2' 

In this case, character string 1 and character string 2 are compared 
character by^character for a match, if they do not match, then the 

is tslse. If they have the Bame length and 
match, then the value of the expression is true (OFFFFH). ^ 

The reset operator (.RES.) unconditionally resets any overflow error in 

shift operators shift their first argument 
right or left by the number of bit positions given in their second 
argument. Zeros are shifted into the vacated bit positions. The 
negative (2s complement) of an expression may be formed by preceding 

The one's complement of an expression may be 
formed by preceding it with the .NOT. operator. ye 

The symbol $ is used to represent the value of the program counter of 
Instruction. Version 3.2 of the Assembler accepts both 
conventions that are used in Z-80 assembly language in regard to the 
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relative jump, JR, and the decrement B, jump relative non zero 

In the earlier convention, the argument required thar 

counter value be subtracted from a label value ^h^ later 

does not require the assembly source to mate this cJlcilatron ^ptJcU? 


example 


JR LOOP-$ 


JR LOOP 


- will jump relative to label LOOP, 


Note that enclosing an expression wholly in parentheses indicates a 
memory address. The contents of the memory address equivalent ^^the 
expression value will be used as the operand value. to the 

The allowed ranp of an expression depends on the context of its use 

instruction are -I 26 a^d 

6.6 COMMENTS 

A comment is defined as any characters following a semicolon (•) in a 
iifA* ^semicolon in quotes in an operand is treated as an expression 
rather than a comment starter. Comments are ignored by the Assembler 

any c^Ln" can KgTn 


6.7 ABSOLUTE MODULE RULES 

The pseudo-op 'PSECT ABS' defines a module to be absolute The oronr^m 
will be loaded in the exact addressee at which it if ass^mble^'^ ?Ms 
IS useful for defining constants, a common block of global symbols or 
a software driver whose position must be known. This method can be 
used to define a list of global constants as follows; 


EXAMPLE 


PSECT ABS 
GLOBAL AA 
EQU 0E3H 

GLOBAL AX 
EQU 0AF3H 

END 


.•ABSOLUTE ASSEMBLY 


6.8 RELOCATABLE MODULE RULES 


iseflf fr-plKS'Lf [f SSef "ot 

2. Only those values which are 16-bit address values will be relocated. 
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16-bit constants will not be relocated. 

EXAMPLE 

EQU 0A13H ;ABSOLUTE VALUE 

LD A,(AA) ;AA NOT RELOCATED 

5 ; RELOCATABLE VALUE 

(AR) ;AR will be RELOCATED UPON LINKING 

3. Relocatable quantities may not be used as 8-bit • 

reloLteS by thril 


EXAMPLE 


EQU 

DEFB 

LD 

LD 

LD 


$ ;RELOCATABLE VALuE 

lab ;N0T ALLOWED 
A»(IX+LAB) ;N0T ALLOWED 

A,(LAB) ;ALLOWED 
HLyLAB ;ALLOWED 




EXAMPLE 


20H jCONSTANT 

B8 ;CONSTANT 

A,(C8 ) ;C8 WILL NOT BE RELOCATED 

$ ;RELOCATABLE ADDRESS 

AR ;RELOCATABLE 

A,(BR) ;BR will BE RELOCATED 


5. External symbols in a relocatable program are marked reinr^ai-sKi^ 
except for the first usage. The code for external 

a backward link list through the object code* yrobols is actually 


6.9 GLOBAL SYMBOL HANDLING 

. .. /'a ‘ 1 

va?:e‘’'a:«Saa‘M;"o“e K* 

s5i^El!s'^“unkar "it*- It by“?hl Id 

PMuL-op!' * 9lob«l symbol IS aefinea as such by the GLOBAL 

EXAMPLE 


GLOBAL SYMl 
CALL SYMl 


JDEFINE GLOBAL SYMBOL 
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er 


END 


EXAMPLE 


SYMl 


EQU 

LD 


SYMl is an external symbol 


GLOBAL SYMl .-DEFINE GLOBAL SYMBOL 


A, (SYMl) 


END 


- SYMl is an internal symbol. Its value 
IS the address of the LD instruction. 


r'"® assembled and then linked by the SD SYSTEM^ 
Linker, then all global symbol references from the firL proqram woul^ 

be resolved . This means that each address in which an exterff;rT 
symbol was used would be modified to the vai.,^ < exterital 

internal syn,bol. The linked prograL ionld be IquWalent uHna eSS 
example) to one program written as follows. equivalent (using out 

EXAMPLE 


CALL 


SYMl 


SYMl 


EQU 

LD 


A, (SYMl) 


END 

Global symbols are used to allow large programs to be broken ud inb 
smaller modules. The smaller modules are used to ^sroroaraLi 

same^team! programming by different memblrs^ of tt 


6.10 GLOBAL SYMBOL RULES 


operatorI“''"*'^ symbol cannot appear in an expression which uses 

example 

GLOBAL SYMl jEXTERNAL SYMBOL 

CALL SYMl ;OK 

LD HL,(SYMl+2) jNOT ALLOWED 

2- An external symbol is always considered to be a 16-bit address. 
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Therefore, an external symbol cannot appear in an instruction requirinq 
an 8-bit operand. -ay 

EXAMPLE 

GLOBAL SYMl ;EXTERNAL SYMBOL 
CALL SYMl ;OK 
ED A,SYMl ;NOT ALLOWED 

external symbol cannot appear in the operand field of an EOU or 

4. An internal symbol is always marked relocatable in a relocatable 

assembly. This point is important because an internal symbol will 

always be relocated even though it looks like a constant. To define 

fcreate an absolute assembly via the PSECT 
ABS pseudo-op. 

5. For a set of modules to be linked together, no duplication of 

names IS allowed. That is, an internal symbql'can be 
defined only once in a set of modules to be linked together. 

7.0 TECHNICAL INFORMATION 


The Assembler is resident on a CP/M compatible system diskette and, 
when loaded, starts at location lOOH. Assembler variables are olaced 
in memory at the top of the Assembler. The symbol table is placed in 
RAM starting at the end of the Assembler and ending at the startinq 
program Typically, more than 300 symbols are allowed per 
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SD SYSTEMS LINKER VERSION 2.0 
OPERATIONS MANUAL 


COPYRIGHT SD SYSTEMS 

NOVEMBER 1978 

ALL RIGHTS RESERVED 


1.0 INTRODUCTION 


SD SYSTEMS Linker is provided on a /»• 

diskette. The Linker (LINKr provides tL meanf fo? 
modules produced by the 280 Assembler (ZASM). The Linker co^cltenates 
modules together and resolves global symbol references which 
communication between modules. The Linker orof^urpc a i^ 
containing "hex" format machine code which may be read by the DOS^LOAD 
commmand. The LOAD command reads a load module (secondLy lilenLe - 
produces a memory image file (secondary filename^= COh) which 
can be executed by the disk operating system (DOS). 


2.0 COMMAND SUMMARY 


In this manual, the following symbols are used: 

“ (CR) means carriage return. 

“ all user input is underlined. 

~ user input which is all upper case must 
be entered exactly as shown, 
user input which is lower case is variable. 


filename 2,-filename N /xyz (CR) 

Links object input files (secondary filename=OBJ) 
Produces a LOAD module (secondary filename=HEX) 

- As an option creates a cross reference file 
(secondary filenaroe=CRS) 

OPTIONS 

C - Produces an output file containing a global cross 
reference table and a load map. 

U - Lists all undefined global symbols 
A - Allows the user to enter a starting link address 


3.0 DEFINITIONS 


SOURCE MODULE - the user's source 
assembled into one object module by 


program. Each source module is 
the Assembler. 
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module -^the^ Object output of the Assembler for one source 
module. The object module contains linking information, address and 
relocating information, machine code, and checksum information for use 

Linker. The ob]ect module is in ASCII. The object module is 
output to a disk file with extension OBJ. 


LOAD MODULE - the absolute 
load module is defined 
secondary filename of HEX. 


machine code of one complete program. The 
on disk as an absolute object file with 
A Load module is produced by the Linker. 


GLOBAL DEFINITION - both internal and external symbols are defined as 
GLOBAL in a source module. The Assembler determines which are internal 
and which are external. (See 280 Assembler description of internal and 
external symbols). 


ABSOLUTE - a program which has no relocating information in the object 
module. An absolute program which is not position independent can be 
loaded only in one place in memory in order to work properly. 

RELOCATABLE - a program which has extra information in the object 
module which allows the Linker to place the program anywhere in memory. 


4.0 LINKER OPERATION 


During Pass 1 the Linker reads one or more object input files and 
places the global symbol definitions in the Linker symbol table. In 
PASS 2 global symbol references are resolved and an output Load file is 
produced. The Load file has the same primary filename as the first 
object input file (filename 1) and has a secondary filename of HEX. If 
the cross reference option is specified a cross reference file is 
produced. The cross reference file has the same primary filename name 
the first object input file (filename 1) and has a secondary filename 


In Pass 2 as each object input module is read its beginning and ending 
address in memory is printed on the console. The module type is also 
listed as either absolute or relocatable (ABS/REL). Absolute modules 
are always positioned at their starting address in memory as defined by 
the ORG pseudo-op. Relocatable modules are positioned at the next 
location after the end address of the previous module. If the first 
input module is relocatable, it is positioned by the starting link 
address. If the starting link address is not specified by the A option 
it assumes a value of 0. f 


It is suggested that the first object input module read by the Linker 
have a starting address of lOOH for operation with the DOS. This 
starting address should also serve as the entry point for the combined 
Load module. A starting address of OlOOH can be created either with 
the ORG pseudo-op or the Linker A option. The DOS loads and begins 
execution of RAM image files at location OlOOH. ^ 
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When absolute modules are ^ 

command must appear in sequentlll in the link 

addresses in memorv tf according to their e*-! 

starting address lowr in memori‘'‘than'^“*® “ encountered haJing"a 
sequence error message will be oeno^^f j ^ Previous module a module 
module contains more than one OR? fntthermore, if % sluro? 

.tven ORC statement must be l^lat^tb^fr^^^iJS! 


5.0 EXAMPLE OF LINK COMMAND 


,SUB2.OBJ,SUB3?0Bj*^^togJther^stlrf°*^^^^^ modules MAIN.OBJ, SUBI OBJ 
main HEX Also JOOH producing th^LofHoduJe 

in the file MAIN.CRS. ^ referecne table and a load map 


A>LINK main,SUBI,SUB2,SUB3 (CR) 

OPTIONS? A C (CR) ' 


ENTER STARTING LINK ADDRESS> 100 (CR) 


MAIN 

SUBI 

SUB2 

SUB3 


.OBJ 

.OBJ 

.OBJ 

.OBJ 


UNDEFINED SYMBOLS 00 
PASS 2 

•OBJ pel 
•OBJ REL 
• OBJ REL 
•OBJ REL 


MAIN 

SUBI 

SUB2 

SUB3 


BEG ADDR 0100 
beg ADDR 0126 
BEG ADDR OlCE 
beg ADDR OlEg- 


END ADDR 0125 
END ADDR OlCD 
end ADDR 01E8 
end ADDR 0212 


A>L0AD main,hex (CR) 


A>MAIN (CR) 


NOTE: Execution of MAIN has been started. 


example 3. Using the DOS tvdp j . 

table and the load map for the modules Jlnke^iVExampir?!® 


A>TYPE MAIN.CRS (CR) 


C-3 
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LOAD 

MAP 





MAIN 

• OBJ 

REL 

BEG 

ADDR 

0100 

SUBl 

.OBJ 

REL 

BEG 

ADDR 

0126 

SUB2 

.OBJ 

REL 

BEG 

ADDR 

OICE 

SUB3 

.OBJ 

RBL 

BEG 

ADDR 

01E9 


END ADDR 0125 
END ADDR OICD 
END ADDR 01E8 
END ADDR 0212 


GLOBAL CROSS REFERENCE TABLE 


SYMBOL ADDR 
CRLF E59C 
MAIN 0100 
MODNO OlFB 
MSGBEG 013F 
MSGEND 0165 
MSGMAI 018A 
MSGMOD 01C2 
MSGSB2 0195 
MSGSB3 019B 
PRINT OlEO 
PTEST 0138 
SUBl 0126 
SUB123 020F 
SUB2 OICE 
SUB3 01E9 


REFERENCES 
020C 01E6 

01D4 OlDl 012C 0129 OlOC 0109 
0101 
OllE 
OlOF 
0201 
01D7 
01F2 

01F5 013C 0132 0121 0112 0104 

01F8 OIDD 

0115 

0118 

OllB 





